package com.lyc.dao;

import com.lyc.bean.Express;
import com.lyc.exception.DuplicateCodeException;

import java.util.List;
import java.util.Map;

public interface BaseExpressDao {

    /**
     * 用于查询数据库中的全部快递（总数+新增），待取件快递（总数+新增）
     * @return [{size:总数, day:新增}， {size:总数, day:新增}]
     */
    public List<Map<String, Integer>> console();

    /**
     * 用于查询所有快递
     * @param limit 是否分页的标记，true表示分页，false表示查询所有快递
     * @param offset SQL语句的起始索引
     * @param pageNumber 页查询的数量
     * @return 快递的集合
     */
    public List<Express> findAll(boolean limit, int offset, int pageNumber);

    /**
     * 根据快递单号查询快递信息
     * @param number 单号
     * @return 查询的快递信息，单号不存在时返回null
     */
    public Express findByNumber(String number);

    /**
     * 根据取件码查询快递信息
     * @param code 取件码
     * @return 查询的快递信息，取件码不存在时返回null
     */
    public Express findByCode(String code);

    /**
     * 根据手机号码查询快递信息
     * @param userPhone 手机号码
     * @return 查询的快递信息列表
     */
    public List<Express> findByUserPhone(String userPhone);

    /**
     * 根据手机号码和状态码判断快递是否已取
     * @param userPhone 手机号码
     * @param status 状态码
     * @return
     */
    public List<Express> findByUserPhoneAndStatus(String userPhone, int status);

    /**
     * 根据取件的数量对人员进行排名
     * @param sysPhone 录入人手机号码
     * @return 查询的快递信息列表
     */
    public List<Express> findBySysPhone(String sysPhone);

    /**
     * 快递的录入
     * @param e 要录入的快递对象
     * @return 录入的结果，true表示录入成功，false表示录入失败
     */
    public boolean insert(Express e) throws DuplicateCodeException;

    /**
     * 快递的修改
     * @param id 要修改的快递id
     * @param newExpress 新修改的快递对象(number, company, username, userPhone)
     * @return 修改的结果，true表示录入成功，false表示录入失败
     */
    public boolean update(int id, Express newExpress);

    /**
     * 更改快递的id为1，表示取件完成
     * @param code 要修改的取件码
     * @return 修改的结果，true表示录入成功，false表示录入失败
     */
    public boolean updateStatus(String code);

    /**
     * 根据id删除单个快递信息
     * @param id 要删除的快递id
     * @return 删除的结果，true表示录入成功，false表示录入失败
     */
    public boolean delete(int id);
}
